home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Die Speccy' 97
/
Die Speccy' 97.iso
/
amiga_system
/
the_aminet
/
util
/
cli
/
akcc36.lha
/
Help
/
english
/
Tips.doc
< prev
next >
Wrap
Text File
|
1995-08-08
|
20KB
|
573 lines
AKCC V3.5
- Additional Manual for AKCC in English -
⌐ 1989-94 by Andreas R. Kleinert.
All rights reserved.
Date of last changes : 27.07.1994
=============================================================================
Common Information :
=============================================================================
All AKCC-Commands are self-explaining. They print an english information
text, when started with "?" (e.g. "ExtShow ?").
More and detailed hints are written down here.
The AKCC-Commands are written and tested under OS 3.00 since a long time.
So full compatibility is ensured.
All commands need at least Kickstart V1.2, but the following commands
do also contain special code-modules for OS V2.04+ :
- ExtShow
- KAssign
- DosRequest
Detailed Information on the single commands and their sub-groups follow.
Commands with "-a"-Support :
=========================================================================
"-a" stands for "-all" and describes recursive, that means (in this case)
complete access to ALL sub-directories by the specific command.
Commands with "*"/"#?"/"?" WildCard-Support :
=========================================================================
These WildCards are equivalent to the Standard-AmigaDOS-WildCards
"#?" and the ARP-WildCard "*" (as under MS-DOS or other Operating Systems).
It is also possible to use more than one WildCard in a name-descriptor,
which is not common to all of the Standard-AmigaDOS-Commands (especially
under OS <= V1.3) :
e.g. : - Kill Vie*l*
(deletes e.g. "Viele", "VielMehr", "VierBilder", etc.)
- ExtShow sta*t*
or
ExtShow sta#?t#?
(lists e.g. "startup-sequence".)
The special SingleChar-WildCard of AmigaDOS ("?") is also supported,
which allows to replace only one (or none) char instead of an unlimited
number.
All users of OS V2.04 or greater have ADDITIONALLY access to the new
WildCards of V37-DOS, so that at first DOS-PatternMatching is used,
and if the pattern "still does not fit" after that, the internal
routines of "akcc_gen0.library" are used instead.
This results in the following additional WildCards :
~ logical NOT
(String_1|...|String_n) logical OR (brackets allowed)
Combinations are possible.
Also the "WildStar" ("*") can be used, because the "akcc_gen0.library"
activates it automatically.
=============================================================================
CheckExec
=========================================================================
CheckExec prints out informationen about the system's configuration :
e.g. CPU, FPU, PAL/NTSC, various addresses,
Viruses ?, ...
CheckExec also allows to view Bootblocks of Disks :
e.g. CheckExec CHECK DF0:
displays the Bootblock of a disk in the internal drive "DF0:".
The "FORMAT [DF(0|1|2|3):] allows to format diskettes.
Only 837 KB disks are supported.
This option may only concern users of OS 1.2 so far.
DateAct
=========================================================================
This command merges two of the Standard-AmigaDOS-Commands.
It changes the internal Clock (CIA-Timer based) as well as
it is able to access the (optional) batterie-buffered realtime-clock
(only supports type MSM 6242 B, e.g. in most im Amiga 500 plus models).
Meaning of the options :
- <Date description> CIA-Timer are set new
- LOAD Loads CIA-Timer with realtime-clock
values and displays them
- SAVE <Date description> Set realtime-clock to date
Direct copies from CIA-time to realtime-clock are not supported.
The reverse way should be gone always.
(First set realtime-clock, then copy to Timers, or even not.)
Display
=========================================================================
Display support printing files in different ways, e.g.
as ASCII, hexadecimal, octal, C- and Assembler-SourceCode,
to the Console (default) or any other DOS-Device, as well as
into a file.
Normal/ASCII : (Default)
Hexadecimal : HEX
Octal : OCT
C-Source : C (Byte-Array)
Assembler-Source : ASM (dc.b-field)
DosRequest
=========================================================================
This program allows easy opening of Requesters from Batch-Files,
to let the user decide, what actions to perform next.
Use this excerpt from a Batch-File as a demonstration :
; Begin of Batch-File
DosRequest "Should I continue ?" "Yes" "No"
if warn
echo "You selected 'No' !"
else
echo "You selected 'Yes' !"
endif
; End of Batch-File
Under OS V2.04+ "AutoRequest()" will be replaced by the V37-Intuition-
Function "EasyRequest()".
This allows greater comfort and higher flexibility for requesters, then.
EnvAct
=========================================================================
Selection of a specific action is done via commandline parameters :
EnvAct INIT <...> - creates ENV: (NewDir + KAssign)
EnvAct WRITE <...> - writes an Env-Variable
EnvAct READ <...> - reads an Env-Variable
EnvAct STREAM <...> - prints out the content of an Env-Variable
EnvAct ERASE <...> - erases an Env-Variable
STREAM results in printing out only the content of the Variablen
(only a linefeed attached, no more explaining texts), so that
the result may be used with other programs (e.g. via Backticks
under OS V2.04+).
Existance of "ENV:" is needed for using this command.
ExecLibs
=========================================================================
ExecLibs may also load Libraries and flush unused ones out of memory
(if #=0, and the Library has been loaded to RAM and is not a ROM-
resident one), if the specific Library supports this.
ExecLibs offers basically the same options in using WildCards (for
removing) as "KillTask" or "PriSet".
But always ALL Libraries, which match the WildCard string are removed.
But - different to the handling of Tasks - there are never two or
more libraries with exactly the same name, which makes selection
somewhat easier.
When loading Libraries (from "LIBS:") the full name of the Library
(as e.g. "42.library") has to be specified.
"akcc_gen0.library" cannot be removed via ExecLibs, because ExecLibs
itself does use it.
Use "flushlibs" (Workbench-Menu) instead to do this (available
when started in "-debug" mode).
List of options :
-----------------
ExecLibs LOAD <Name>
- Loads a Library from LIBS: to memory
ExecLibs KILL <NamePattern>
- Removes all the Libraries from memory, which match the
pattern (WildCards : "?", "#?", "*").
Attention : Somtimes two or more calls are useful, because may
Libraries also open other Libraries, which then can
be removed also later.
ExecLibs VIEW
- All resident Libraries are displayed.
Option is not needed (typing "ExecLibs" suffices).
You may also access the command "ExecDevs" in the same way as this has
been described above for "ExecLibs".
ExecMem
=========================================================================
Display free memory and allos addiotional options :
The results may be written to an Environment-Variable (e.g. for use
by an other program).
e.g. : ExecMem CHIP VAR=<Variable-Name>
(writes size of free CHIP mem to ENV:<Variable-Name>)
Syntax :
1. ExecMem
=> print out complete information
2. ExecMem <type of memory>
allowed types :
CHIP -> CHIP-Memory
FAST -> FAST-Memory
SUM -> CHIP- & FAST-Memory
=> print out specific information only
3. ExecMem <type> VAR=<Variable-Name>
=> writes size of free memory of a
specific type to an Env-Variable
FullPath
=========================================================================
FullPath replaces the Standard-Command Path in a way, which
is especially useful for HardDisk owners :
Usually there are masses of sub-directories on a HardDisk, of which
many also have to be seacherd for commands.
This might be frustratin, if the most-often used commands are placed
in a directory, which is placed at the end of the search-list.
Even a fast HardDisk takes some time to load a command, then.
FullPath allows to declare a List of Paths (from a File) as the
current List, where also the order of the entries is respected
(first Path at first, last Path at last).
The current directory is always searched at first, indepently from
that.
Another adavantage : You only have to call one command, no matter
if there are e.g. 30 Paths to be searched.
Attention : The old PathList is always deleted !
Tip : "C:" is usually searched at last, no matter if it is actually
in the list or not.
If you specify it at the begining of the list, it will be
be searched directly after the current directory.
Very useful !
An example list :
C:
SYS:
SYS:System
SYS:Tools
SYS:Utilities
A new line for any new entry !!!
When calling from CLI, there also may be added/removed single
entries via ADD/REMOVE.
HunkShow
=========================================================================
This program show the Hunks of Program- or Objekt-Files
(only SAS/Lattice-compatible formats).
It also knows the follwing file-types :
1a) FORM-???? (IFF-Files)
b) LIST,PROP,CAT (extended IFF-Files)
2) PowerPacker 3.0a/b (packed programm -> PowerPacker)
3) PP20 (packed file -> PowerPacker)
4) -lh?- (archive in the "-lh?-" format)
5) MMD0, MMD1 (MED-Module, OctaMED-Module)
6) MED (MED-Sound)
7) HDBackup Logfile (Logfile for HDBackup of WB V2.04+)
8) .key (many batch-files begin this way)
9) .info (Info-File of Workbench V1.x+)
10) ZOO (Archive in the "ZOO"-Format)
11) ZOM (Archive of ZOOM)
12) TFMX-SONG (TFMX-Sound-Module)
13) FC (Future_Composer-Sound-Module)
14) RIFF-???? (RIFF-File, PC-Standard)
15) AmigaGuide File (AmigaGuide Online-Documentation)
16) VOC SoundSample File ("Creative Voice File"-Sample)
KScroller
=========================================================================
This program allows to use an ASCII file as the source for a simple
"Text-Scroller" in the CLI/Shell (various speeds).
When combined with "Texter" there are offered many possibilities
for printing texts in the CLI/Shell.
KillTask
=========================================================================
There are two possibilities to use KillTask, to remove Tasks from
the system :
1. "BREAK"
This does never affect the system and is nearly always SAFE.
Any available CTRL-Break-Signale will be sent to the Task, so that
it will immediately, if it supports one of them.
Don't forget the keyword "BREAK", which is the only difference
the method two.
Example :
KillTask BREAK Exchange
2. "REMTASK"
This one will remove the Task via Exec's "RemTask()" ALWAYS.
Removing tasks this ways has many (almost only) disadvantages, but
is useful to remove tasks, which crashed "silently".
KillTask does is not case-sensitive, concerning the Task-Names,
which makes usage much easier.
Also usage of WildCards, as with the file-orientated commands,
is supported ('#?'/'*'/'?').
Basically the first Task, which fits the name or pattern is removed,
but if you specify the option "-a", ALL matching Tasks/Processes
will be removed instead.
Examples :
KillTask THISONE (kills current task : should NEVER
be done)
KillTask "Background CLI" (kills first task named
"Background CLI")
KillTask "Background CLI" -a (kills ALL tasks named
"Background CLI")
KillTask "Back*" (kills first task beginning with
"Back")
KillTask "Back*" -a (kills ALL tasks beginning with
"Back")
Attention : If any of the REMOVEd (not BREAKed) tasks still had any
resources allocated, e.g. opened Windows, those will NOT
be given free. (You should minimize the Window's sizes.
The next reset will clear this up.)
KInfo
=========================================================================
Meaning of the "status" field :
"NoWrite" : write-protected
"Val'ing" : (at the moment) not validated
"Valid" : valid and not write-protected
"???????" : unknown or invalid status-value
Volume-Type :
string meaning since OS DOS-ID
"unreadable Disk" <- 'BAD\0'
"no Disk present" <- -1
"not a DOS-Disk " <- 'NDOS'
"OFS " OldFileSystem 'DOS\0'
"FFS " FastFileSystem V1.3 'DOS\1'
"OFS INTL " international OFS V2.04/3.00 'DOS\2'
"FFS INTL " international FFS V2.04/3.00 'DOS\3'
"OFS INTL CACHE " international OFS, Cache V3.00 'DOS\4'
"FFS INTL CACHE " international FFS, Cache V3.00 'DOS\5'
"Kickstart-Disk " Kickstart-Diskette 'KICK'
"MSDOS-Disk " PC-Formatted Diskette V2.04/V3.00 'MSD\0'
When entering an unknown DOS-ID, the Hex-Value will be printed
like in C ("0x...").
The (international) FileSystems with DirectoryCache (DirCache)
are also described as "DCFS" sometimes.
But because the are two available of this kind, we do not use
this description here.
The "By/Blo" value describes the number of Bytes per Block, which
the correspondings File-System uses. These are e.g. 488 for
OFS-Disks, 512 for FFS-Disks and 1024 for the Ram-Disk.
Less information on the structure of the saved data (per Block)▒t
results in a higher diskspace with FFS-Disks, compared against
the old OFS-Disks (24 Bytes additionally per Block).
LED
=========================================================================
The LED command support batch files, in a way that its return code
is "boolean", when started with the "-batch" option.
Example :
; Begin of Batch-File
LED -batch
if warn
echo "LED is ON !!!"
else
echo "LED is OFF !!!"
endif
; End of Batch-File
LED may be useful, if e.g.
- Soundprogramms "forgot", to turn the LED (again) ON or OFF
- the LED is not visible (tower construction or defect LED)
- the LED should be controlled automaticalle (e.g. from Batch-Files)
- and many more
Move
=========================================================================
This command allows "moving" of files by "deletion-after-copy".
So files may transferred from one directory to another by copying them
and then deleting the source.
This is a replacement for the "Rename" command, if it is to be used
"across device borders".
PrefSet
=========================================================================
PrefSet is a kind of "Mini-Preferences" for the CLI.
Modifyable parameters are similar to the standard Preferences-programs,
but easier to set.
Useful for "CLI/Shell-only" users.
Warning :
- Keyrepeat values should be modified with care, because they
may affect any further keyboard operation very much.
- Under OS V2.04+ you should use the new preferences instead
(althoigh this program is still compatible).
- The "CLI - ON/OFF" option only works under OS-Versions below or
similar to V1.2. Since OS V1.3 this one is obsolete (ignored).
PriSet
=========================================================================
Priorities should be between -20 and +20 (better : -5 / +5),
so that the task-switching is not affected in any way.
Common values are : -1 / 0 / 1.
PriSet offers the same WildCard options as e.g. also "KillTask".
Texter
=========================================================================
All font-attributes and other settings may be modified via special
controlcodes (no ESCAPE-sequences needed).
Example :
Texter "\B\I\C=0,1Hello !\N\C=1,0" >PRT:
Results in bold, italic "Hello !", with foreground color 0 and
background color 1 (passed to printer).
After that the old settings are restored.
Possible controlcodes :
atributes :
\N : normal
\B : bold
\I : italics
\U : underlined
\R : reverse
colors :
\C=<FG>,<BG>
characters :
\\ : "\"
\42 : " itself
format control codes :
\n : linefeed
\b : backspace
\f : clrscr
\t : TAB
\r : carriage return
Font attributes always have to be specified BEFORE colors, because
otherwise the colors would be reset again when setting the attributes.
WinAct
=========================================================================
This command allows the modify the active CLI-/Shell-Window in
an easy way (e.g. fromout Batch-Files) :
Size-adjustment options :
- PAL (640 / 256)
- NTSC (640 / 200)
- BIGGEST (Max / Max) <- see Preferences
- X=<x> Y=<y> ( x / y ) <- First X, then Y (only TOGETHER)
Position-adjustment options :
- POSLEFT (Window will be moved to upper, left corner.)
Other options :
- NAME=<Name> (Window title will be changed.)
=============================================================================